Aviation API

A Significant Weather chart is a chart indicating forecast position of jet streams, tropopause heights, thunderstorms / Cumulonimbus (CBs), turbulence, and fronts. Charts are issued 4 times a day (valid at 00, 06, 12, and 18 UTC) and reported at two altitude levels (mid and high). The “mid” level endpoint returns data for altitudes from 10,000 to 25,000 ft. The “high” level endpoint returns data for altitudes above 25,000 ft. (usually up to 63,000 ft.). Airline applications shall be able to query SigWx charts which indicate forecast position of different meteorological phenomenon.

There are three versions of the mid level chart these are:
1. Mid Level SIGWX – Displays all phenomena (moderate or severe turbulence, moderate or severe icing, cumulonimbus (CB) cloud associated with thunderstorms, tropical cyclones, active volcanic eruptions, radioactive material).
2. Mid Level SIGWX – CB & Icing – Displays all phenomena excluding turbulence (moderate or severe icing, cumulonimbus (CB) cloud associated with thunderstorms, tropical cyclones, active volcanic eruptions, radioactive material).
3. Mid Level SIGWX - Turbulence – Only displays moderate or severe turbulence.

Airline applications shall be able to query SIGWX charts which indicate forecast position of different meteorological phenomenon.

5.1 By Chart, Level and Validity

5.1.1 Description:

Request the latest prognosis chart for the specified chart identifier, level, validity and optionally specifying that a colour chart is required (if applicable for the given chart identifier). They are issued 4 times a day valid at 00, 06, 12, and 18 (UTC).

5.1.2 API Call:

GET /aviation/chart/sigwx/{chart}/{level}/{validity}/{phenomenon}

5.1.3 Path Parameters:

5.1.4 Table of Charts:

5.1.5 Example:

This example would return a link to the highlevel SigWx chart for identifier 795 with a valid at time of 1800 hours UTC.

All SigWx charts are forecasts and as such have a prognosis period of 18 hours from the issue time.

GET /aviation/chart/sigwx/795/high/18

5.1.6 API Response:

{
    "version": "1.0",
    "issue-time": "2021-10-04T23:09:12Z",
    "path": "/chart/sigwx/795/high/18",
    "response": [
        {
            "av:sigwx-chart-id": "795",
            "av:sigwx-level": "high",
            "met:locator": "https://api.metservice.com/aviation/assets/sigwx/202110041800_aviation_795_high_h_18.png",
            "met:product-name": "sigwx",
            "met:domain": "aviation",
            "met:issue-time": "2021-10-04T01:32:12Z",
            "met:valid-at": "2021-10-04T18:00:00Z",
            "met:validity": "18"
        }
    ]
}

5.2 By Chart and Level for the next n hours

5.2.1 Description:

Request the prognosis charts for the specified chart identifier, level and optionally phenomenon type, that have a valid at time which is within the next n hours specified.

5.2.2 API Call:

GET /aviation/chart/sigwx/{chart}/{level}/{phenomenon}/next/{n}/hours

5.2.3 Path Parameters:

5.2.4 Example:

This example would return a set of links to the mid level, turbulence SigWx charts for identifier 920 with a valid at time that is within the next 24 hours from ‘now’.

GET /aviation/chart/sigwx/920/mid/turbulence/next/24/hours

5.2.5 API Response:

{
    "version": "1.0",
    "issue-time": "2021-10-04T23:05:34Z",
    "path": "/chart/sigwx/920/mid/turbulence/next/24/hours",
    "response": [
        {
            "av:sigwx-chart-id": "920-turb",
            "av:sigwx-level": "mid",
            "met:locator": "https://api.metservice.com/aviation/assets/sigwx/202110051200_aviation_920-turb_mid_h_18.png",
            "met:product-name": "sigwx",
            "met:domain": "aviation",
            "met:issue-time": "2021-10-04T19:34:17Z",
            "met:valid-at": "2021-10-05T12:00:00Z",
            "met:validity": "12"
        },
        {
            "av:sigwx-chart-id": "920-turb",
            "av:sigwx-level": "mid",
            "met:locator": "https://api.metservice.com/aviation/assets/sigwx/202110050600_aviation_920-turb_mid_h_18.png",
            "met:product-name": "sigwx",
            "met:domain": "aviation",
            "met:issue-time": "2021-10-04T13:33:13Z",
            "met:valid-at": "2021-10-05T06:00:00Z",
            "met:validity": "06"
        },
        {
            "av:sigwx-chart-id": "920-turb",
            "av:sigwx-level": "mid",
            "met:locator": "https://api.metservice.com/aviation/assets/sigwx/202110050000_aviation_920-turb_mid_h_18.png",
            "met:product-name": "sigwx",
            "met:domain": "aviation",
            "met:issue-time": "2021-10-04T07:34:20Z",
            "met:valid-at": "2021-10-05T00:00:00Z",
            "met:validity": "00"
        }
    ]
}